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ABSTRACT 



This study examines the database application programming 
environment presented by the App 1 ications-By-Forms (ABF) 
subsytem of the INGRES database managenent system (DBMS). 



The development of 


a 


bibliographical search and 


report 


app 1 icat ion 


program 


i s 


d i scussed . 


The operation 


of the 


app 1 i cat i on 


program 


1 s 


descr ibed. 


Positive and 


negative 



aspects of the ABF programming environment are examined. 
The use of INGRES Query Language (QUEL) and Operation 
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1 NTRODUCT I ON 



I . 



INGRES is a m i n i computer -based database management 
system (DBMS) developed and distributed by Relational 
Technologies Incorporated ( RT I ) . This work assumes that the 
reader is familiar with the various classes of data bases 
and therefore, without any further explanation of the 
various database classifications CRef. 11, it is simply 
stated that INGRES is classified as a relational database 
The noteworthy feature of INGRES is its visually oriented 
user interface. Rather than presenting the user with the 
’’normal” text oriented display, INGRES presents the user 
with a form with which to insert (append) data into the data 
base or with which to extract (query) data from the data 
base. As has been seen from the user interface research 
done by XEROX PARC, Apple Corporation’s Macintosh Division, 
and others, there is an increasing trend toward more 
visually oriented user interfaces. Chernicoff CRef. 21 

explains this trend as a reflection of the philosophy at the 
Macintosh Division that the user interface should be one 
which presents the user with a ’’metaphor for life” hence the 



‘ As opposed to a hierarchical, network, or other type 
of database. 
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Macintosh "desk top" with its associated icons for trash, 
files, documents, and so forth. Although not as elaborate 
as the Macintosh interface, INGRES does present the database 
user with its own "metaphor for datab ase life" and its 
associated icon is the form. As explained by RT I CRef. 3], 
"A form is similar to a paper form that you fill in. A 
computer form appears on the CRT of the terminal, and it 
provides blank spaces in which the computer displays 
information or you enter information." In addition to 
providing the user with the form for data entry and 
manipulation, INGRES also provides the "report" and the 
"graph" for the formatting of data output into a variety of 
formats. The INGRES DBMS is composed of several subsystems 
which will be described briefly in the remainder of this 
chapter. The purpose of this thesis is to examine and 
critique the INGRES subsystem called App I i cat i ons -By-Forms 



( ABF ) , which 


purportedly permits 


the 


user to 


build 


independent 


database 


app 1 i cat ions 


programs through 


the 


man i pu 1 at ion 


of screen 


based forms. 


The 


examination 


and 



critique of the INGRES subsystem App I i cat i ons-By-For ms (ABF) 
will be accomplished by the development of an independent 
database applications program. The development project is 
described in chapter two and the results are presented in 
Chapter 111. 
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A. INGRES/MENU 

INGRES/MENU is best described as the top or executive 
level of the INGRES system. The user is presented with a 
form (Figure 1) from which he may access any of the various 
INGRES subsystems. INGRES is particularly easy to use in 
this mode due to the abundance of on-line help facilities at 
all levels, beginning with this topmost level. Some of the 
fundamental knowledge the user must know is that a screen is 
actually composed of two entities, a form and a menu. This 
conglomerate is called a frame. The user utilizes cursor 
control keys to move the cursor to an item on the form and 



then presses 


the 


”menu” key 


to select 


an operation 


to 


perform from 


the 


menu at the 


bottom of 


the screen. 


The 



operation is specified by typing the first one or two unique 
characters of the command’s name followed by the ^return” or 
’’enter” key. The menu key is generally the ’’escape” key on 
most terminals. This method of selecting an item and an 
operation to perform on it is consistent throughout INGRES. 

In Figure 1, the menu is the line that reads, ”Go 
History CommandMode DBswitch Shell Help Quit”. The 
remainder of the screen is the form from which items are 
chosen by placing the cursor on the same line as the item 
and then depressing the menu key to select an appropriate 
act i on . 

Figure 1 illustrates all of the subsystems that may be 
chosen from the executive level. Many of the subsystems 
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form related groups by virtue of the similarity of their 



ef f ects . 


For instance, "REPORT", "RBF", and "SREPORT" are 


a 1 1 part 


of the INGRES system that pertains to the 


formatting 


of reports for data output. They will be 



described briefly below. Similarly, "Query’*, "QBF", and 
"QUEL" are all methods of formulating a command to retrieve 
user specified data from the database. 

B. INGRES /QUERY : QUERY-B Y-FORMS 



INGRES 


Query-By-Forms (QBF) facilitates routine 


oper at i ons 


on a database. These routine operations are: 


Query 


- the retrieval of data from the database. 


Append 


- the adding of data to the database. 


Update 


- the changing, usually for the purpose of 
correction, data in the database. 


Delete 


- the removal of data from the database. 



These data manipulations are accomplished on INGRES 
forms. There are two methods of obtaining a form on which 
to operate. First, since relational systems are generally 
thought of as storing data in tables, INGRES can and does 
use the information from the table associated with the 
particular database and query to construct a default form. 
The second option is for the user to create a customized 
form. There are several methods for creating customized 
forms, but the simplest method is to utilize INGRES/FORMS: 
V i sua 1 -Forms -Ed i tor (VIFRED), discussed below. The default 
forms are only satisfactory if the query is relatively 
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simple (i.e., has few elements) or no one other than the 
creating user will be seeing the form. 

Additionally, QBF includes a "Join Definition" phase 
which enables the user to define joins between tables in a 
relational database, selecting only those elements desired 
for display. 

Figure 2 illustrates the opening screen of QBF when 
called from the screen of Figure 1 (INGRES MENU). If the 
user simply orders INGRES to proceed at this point, by 
issuing the "Go" command without entering a form name, then 
the screen appears as in Figure 3. This is the top level 
screen of the INGRES/QBF subsystem. All of the INGRES 
subsystems may be entered directly from outside the INGRES 
system, i.e., directly from the UNIX operating system shell, 
by typing the appropriate system shell level command. If 
QBF is entered in this fashion then Figure 3 is the first 
screen seen by the user. 

Queries may be made based on either a previously defined 
form which has been assigned a QBF name, a table in the 
relation, or a defined join definition by issuing the 
commands "QBFname", "Table", or "JoinDef", respectively. 
These commands are executed from the command menu of Figure 
3. 
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C. INGRES/FORMS : V 1 SUAL-FORMS -ED 1 TOR (VI FRED) 

V I FRED is the INGRES utility system which allows the 
user to either customize the default forms provided by QBF 
and other INGRES subsystems, or build a form completely from 
scratch. There are a few terms which require explanation. 
Any form in INGRES is constructed of trim elements and 
fields. Trim is text which appears on the screen in the 

form of explanatory notes, instructions, etc. Fields are 
those portions of the screen which either display or receive 
data. A field has two components, a title, which is also 
considered to be trim, and a data window which either 
displays or receives data. As with most common computer 
languages, data elements have types such as character, 
floating point, and integer. The capabilities of VIFRED are 
primarily the following: 

- Editing the textual parts of a form, including trim 
elements and field names. 

- Moving elements, trim or field, from one place to 
another on a form. The title (trim) and data window can 
be moved separately. 

- Add new trim elements and fields. 

- Delete existing trim elements and fields. 

- Edit a field's attributes. 

The above operations are also consistent with and 
comparable to those in the INGRES REPORT subsystem. Figure 
4 illustrates the opening screen of QBF when called from the 
screen of Figure 1 (INGRES MENU). If the user simply orders 
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INGRES to proceed at this point, by issuing the ”Go*’ command 
without entering a form name, then the screen appears as in 
Figure 5. This is the top level screen of the INGRES VIFRED 
subsystem. If VIFRED is entered directly from the UNIX 
operating system then Figure 5 is the first screen seen by 
the user. 

D. INGRES/REPORTS: REPORT- BY- FORMS (RBF) 

The RBF subsystem is the complement to the QBF 
subsystem. RBF will provide a default format for data 
output in a fashion similar to that of QBF. The user also 
has the option of editing the appearance and content of the 
default report forms or constructing one from scratch, also 
similar to the capability of the QBF subsystem. RBF has a 
visual forms oriented user interface. RT I CRef. 3, pg 4-12] 
lists the following as the characteristics of a report that 
may be modified using INGRES RBF: 

- content and placement of the report’s title 

- content and placement of the column headings 

- display formats for data items in columns 

- page length (number of lines per report page) 

- under 1 ining 

- how rows of data are sorted in the report 

RBF is only one means of formatting and producing 
database reports using INGRES. Another is the REPORT- 

WRITER. RTI describes the REPORT-WR 1 TER as . . an 
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extensive program that provides maximum flexibility in 
specifying and formatting data for reports.” This increased 
flexibility however, comes at the expense of the visual, 
forms oriented user interface. In order to take advantage 
of the increased flexibility available through the INGRES 
REPORT- WR 1 TER , the user must learn INGRES’S own Report 
Specification Language (RSL). RBF does provide a generous 
subset of the report formatting capabilities of INGRES 
REPORT- WR I TER . Figure 6 illustrates the opening screen of 
QBF when called from the screen of Figure 1 (INGRES MENU). 
If the user simply orders INGRES to proceed at this point, 
by issuing the ”Go” command without entering a form name, 
then the screen appears as in Figure 7. This is the top 
level screen of the INGRES RBF subsystem. If RBF is entered 
directly from the UNIX operating system then Figure 7 is the 
first screen seen by the user. 

E. INGRES/GRAPHICS : GRAPH-B Y-FORMS (GBF) 

INGRES GBF is a forms-based graph definition facility. 
It provides the user with the capability to format data 
output from a database into the form of graphs and charts 
instead of, or in addition to, tabulated report format. 
INGRES GBF also provides the user with some editing 
capabilities with respect to the final form and appearance 
of the various graphs and charts. RT I [Ref. 3, pg 4-14] 
indicates the user determinable features of GBF to be " 
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- the data to be graphed 

- the type of graph to be used (e.g., bar chart, pie 
chart, scatter plot or line chart) 

- line types, dot types, crosshatch patterns 

- content and placement of the graph’s title 

- content and placement of the graph’s legend (optional) 
GBF is not installed at all INGRES installations and is 

not installed on the Naval Postgraduate School Computer 
Science Department’s UNIX/INGRES system. 

F. INGRES/APPLICATI ONS: APPL 1 CAT 1 ONS -BY -FORMS (ABF) 

INGRES Appl ications-By-Forms (ABF) enables the 

1 NGRES/database applications programmer to develop and 
compile database applications programs that will run 
independently of the INGRES system. RT 1 insists that ABF 
can be used to develop an applications program without 
requiring the developer to know a programming language. The 
database program development can be accomplished solely via 
the INGRES forms based visual interface. There are however, 
limitations to the level of sophistication or intricacy of 
an applications program developed under this interface. 
INGRES has provided an extension in the form of a small 
Operations Specification Language (OSL) for those developers 
who desire to ”write” programs of greater sophistication 
than may be developed through the forms interface alone. 
INGRES also provides for the incorporation of modules and 
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procedures written in more conventional programming 
languages such as COBOL, FORTRAN, PASCAL, C, and BASIC. 

An application program developed exclusively through the 
INGRES forms interface tends to take the form of sequences 
of INGRES queries and system commands. This limits the 
flexibility of such a development. In order to realize a 
higher degree of flexibility in program performance it is 
necessary to learn the INGRES OSL. This small language is 
not difficult to learn, consisting of approximately 100 
words or less. The use of OSL is particularly required if 
user defined forms, frames and menus are to be used in the 
application. The degree to which inclusion of modules 
written in conventional languages enhances applications 
program development depends on the proficiency of the 
individual programmer. 

Figure 8 illustrates the opening screen of ABF when 
called from the screen of Figure 1 (INGRES MENU). If the 
user simply orders INGRES to proceed at this point, by 
issuing the ”Go*’ command without entering a form name 2 ^ 

then the screen appears as in Figure 9. This is the top 
level screen of the INGRES/QBF subsystem. If ABF is entered 
directly from the UNIX operating system shell, then Figure 9 
is the first screen seen by the user. 



^ Although a form name is optional, INGRES will not 
proceed without an application program name. 
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II. DEVELOPMENT PROJECT DESCRIPTION 



A. PROJECT OBJECTIVES 

The objectives of the development project were two-fold. 
First, it was necessary to exercise the INGRES Application- 
By-Forms (ABF) subsystem in order to make a fair, objective 
assessment of its capabilities and shortcomings in building 
an application program. Therefore, the first objective was 
ob ject i vi ty. 



Second 1 y 


, the 


project 


itself 


needed 


a 


database related 


app 1 i ca t i on . 


1 1 


was determined 


that 


a 


b ib 1 i ograph i ca 1 


search and 


report 


bui 1 der 


wou 1 d 


serve 


the 


purpose of a 



database- type application. This would also slightly extend 
the objective served by modestly exercising the INGRES 
Report-By-Forms (RBF) subsystem as well. 

B. PROJECT DESCRIPTION 

The development project assumed the form of a 
bibliographical search and report builder and was called 
’’references’’. The program consists of a number of ’’forms” 
defined under the INGRES Visual Forms Editor (VIFRED). 
INGRES ’’forms” are subsequently combined with ’’menus” to 
form ’’frames”. A frame then equates to what a program user 
sees on the terminal screen. The menus are built with code 
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segments using INGRES ABF’s Operation Specification Language 
(OSL) and INGRES’S version of Query Language (QUEL). 

The specific functions performed by the program 
’’references" (the name is not capitalized in deference to 
UNIX operating system convention) are best presented by 
"walking" through an execution of the program and addressing 
the various program functions as they arise. RTI has 

adopted the convention of calling the <Esc> key the "MENU" 
key, due to its RTI-imposed function of placing the cursor 
in the menu line at the bottom of the terminal screen. The 
same convention will be followed throughout the remainder of 
this thes i s . 

1 . Topf rame 

The first frame, called "Topf rame", is shown in 

Figure 10. Its menu is too large to appear on the screen 
and so the INGRES system places a right angle bracket, ">", 
at the right end of the menu, indicating that the menu 

continues off the screen to the right. Pressing the "MENU" 

key results in the same frame, but with the appearance of 
the commands which could not be seen before (Figure 11). 
Note also, that there now appears a left angle bracket, ’’<’’, 
at the left end of the menu to indicate that the menu now 
continues off the screen to the left. 

From Topframe the user may obtain help on the 

various menu selections via "MenuHelp", obtain help on how 
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to move the cursor around the screen via ”Cur so r He 1 p*’ , 
select a function from the main menu appearing on the screen 
above, generate a ’’Report’’ of bibliography type references ^ 
which may be output to either a terminal screen or a line 
printer, or ’’Quit” the program without generating a report. 

If ”Quit” is selected, any data rows that were selected for 
inclusion in an output report during the course of program 
execution are returned to their original state, i.e. 
’’unmarked”. 

2. Topics 

Selecting ”T” for Topics (subject list) results in 
the display shown in Figure 12. There are more ’’Catcodes” 
and ’’Category Names” than can appear in the table on the 
screen. INGRES provides for the scrolling of data in 
tables. ABF automatically includes the INGRES scrolling 
facilities in any application program produced with INGRES 
ABF. <Ctrl> F is used to scroll down the table a screen at 
a time. <Ctrl> G is the complement of <Ctrl> F. <Ctrl> J 
scrolls down a line at a time and <Ctrl> N scrolls down an 
entry at a time. <Ctrl> K is the complement of <Ctrl> J. 

All of the INGRES scrolling functions can be found in the 
help facility ’’CursorHelp” which appears in every screen and 
is described briefly in a later paragraph in this chapter. 
Selecting ’’End” at this point (and in every other screen in 
this application program) would return execution to the 
previous screen. ”MenuHelp” is intended to be unique to 
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each screen; containing an explanation of the menu items and 
options available from the particular screen and its 
associated menu. ’^Titles** provides a list of titles in the 
database whose table entries contain a matching entry for 
the ”Catcode** from whatever row the cursor is on at the time 
"Titles” is selected. 

3. Titles 

Placing the cursor on the first row of the table in 
Figure 12 (Catcode = H5) and selecting "Titles”, causes the 
screen of Figure 13 to appear. This screen’s table field 
also contains more entries than will fit in the table on the 
screen and may be scrolled in the same manner as the last 
screen. All menu selections at the bottom of the screen are 
the same as those in the previous screen and perform the 
same functions, except one. The "Titles” menu item has been 
replaced by one called "View”. The purpose of "View” is to 
permit the user to select a title in the table field of 
Figure 13 by scrolling to it as before and then examine the 
pertinent details that the database contains regarding that 
particular entry. Scrolling to the first item in the table 
field of Figure 13, pressing the Menu key, typing "V" or 
"v”, and pressing <Return> yields the display of Figure 14. 

4 . V i ewf orm 

The display of Figure 14 is called "Viewform". This 
is essentially the bottom level of the application. At this 
point the user may simply view the most important elements 
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of the database entry for this title and then back out via 



the "End” menu function, or "Save” the entry in a customized 
bibliography file. Selecting "Save” marks the entry for 
inclusion in the output report "b i b 1 i o gr aphy . r epo r t " . 
"bib 1 iography. report” is assembled as the user departs the 
program from the entry frame (Figure 10) by selecting the 
menu item "Report" (vice "Quit") in that frame. The output 
report is written to the directory from which the program is 
run, which in most cases should be the user’s own directory. 
The user may also unmark any entry that has been previously 
marked via the "Save" function by selecting "Unsave". There 
is no limit to the number of times an entry may be marked 
and unmarked via "Save” and "Unsave". The functions of the 
remaining menu items remain the same. The frame is departed 
via the "End" command. Three successive selections of end 
returns the user to the entry level frame. The next item to 
examine is the menu item "Keyword”. 

5 • Keyword 

Figures 15 through 17, all illustrate the "Keyword" 
screen. In the previous series, data entry selections were 
made by "pointing" at the item of interest in a list of 
similar items and then selecting from a menu, a function to 
perform on that item. In "Keyword", the user may input a 
key word or phrase that should appear in the title of any 
articles of interest, such as "QUEL” or "INGRES” or 
"RELATIONAL DATABASE". All titles in which the key word or 



20 



phrase appears will be listed in the table field on the 
screen. Although it is not reflected in the illustration, 
the "Word/Phrase *• ” field is highlighted in reverse video to 
draw attention to the fact that this is a required entry. 
The system (INGRES) will also give an explanatory error 
message if an attempt is made to bypass a required entry 
field. The "Keyword” screen initially appears as in Figure 
15. Having specific knowledge of a re 1 at i ve 1 y un i que word 
in the sample database, it is typed in the ”Wor d/Phr ase : ” 
field. The "Keyword” screen now appears as in Figure 16. 
The <Return> key has not yet been pressed at this point. 
Upon pressing <Return> a number of internal actions are 
carried out, a search for titles containing the input word 
or phrase is executed, and the resulting titles are returned 
in the table field. The "Keyword” screen now appears as in 
Figure 17. The table field entry reveals that there was only 
one database entry that satisfied the query and further that 
there was no entry in the "month” column of the relation 
table for this particular row. Moving the cursor to a title 
in the table, pressing the Menu key, typing "V” or ”v”, and 
pressing <Return> will again bring up the "Viewform” screen 
of Figure 14. The functions of the remaining menu items 
remain the same. Selecting "End” returns execution to the 
main menu. 
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6 . 



Authors 



The search for an article by a particular author 
begins with the "Authors” frame shown in Figure 18. The 
prospective user is advised by the text on the screen that 
initials are not required, but are desirable. The reason 
for this is obvious, in that initials will increase the 
uniqueness of the query and return a result closer to that 
which was both expected and desired. The format is 
critical, however, also as noted in the text on the screen. 
The various menu selections are relatively self explanatory. 
Two menu selections will be "demonstrated”, "Author’s name 
Only” and "Author’s name and month and year (All) ...” 

^ • Aut hor’s name Only 

The "Author’s name Only" screen is shown in Figure 
19. The field labeled "Author:" is a mandatory entry field 
just as was the "Uor d/Phr ase : " field of Figure 15. The 
"Author" field has all the same attributes of the 
” Word/Phrase : *’ field, including reverse video. This screen 
also executes its function as soon as the entry is completed 
and the <Return> key is pressed. A list of titles by the 
author of interest (who is not necessarily the only author 
of the article) is returned in the table field provided. 
Using the cursor control functions described earlier and 
discussed further below, any title in the table field may be 
scrolled to and viewed (and subsequently saved for a report, 
if desired). Selecting "End" returns execution to the 
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"Authors" frame. Using the <Tab> key to move back to the 
"Author:" field and typing in another name followed by 
<Return> will execute another query. The functions of the 
remaining menu items remain the same. 

Q • Author and Month and Yea r 

Figure 20 illustrates the "Author and Month and 
Year" frame. The purpose of discussing this frame is that 
it contains multiple required entry fields. They are 
sequenced such that when the "Author:" field entry has been 



completed with the 


customary 




<Return> , 


the 


cursor 


automat i ca 1 1 y 


proceeds 


to the "Month 


:’’ field 


and then 


to the 


’’Year : " field. 


Neither 


of these 


fields requires a <Return>. 


These fields 


"execute" 


as soon 


as 


they are 


full. 


To fill 


the "Month:” 


field 


r equ ires 


a 


s tandar d 


three 


letter 



abbreviation for a month such as "JUN" for June, "DEC" for 
December, and so on. An arbitrary limit has also been set 
on the "Year:" field entries. The only values allowed are 
those four digit integers between 1800 and 2200. Any values 
outside this range will be rejected with an appropriate 
error message. As soon as the "Month" field has received an 
acceptable three letter abbreviation for a month the cursor 
advances to the "Year:" field. As soon as the fourth 
acceptable digit is input, the retrieval begins. The 
functions of the remaining menu items remain the same. The 
next selection to be discussed is the "Publications" menu 
item which closely parallels the "Authors" selections. 
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9. 



Pub 1 i cat i ons 



The ’’Publications” frame is illustrated in Figure 
21. The selection of items from this menu is identical in 
all respects to that of the ’’Authors” menu described above. 
Only the execution of the first selection, ’’Publication’s 
name only”, will be discussed. 

1 0 • Publication’s name only 

Figure 22 illustrates the ”Pub 1 i cat i on” s name only” 
screen. The ’’Publication:” field is a mandatory entry field 
and in keeping with the adopted convention it is in reverse 
video on the terminal screen. There is one significant 
difference between the ’’Publications” series of queries and 
those of ’’Authors” and ”Keywords” described above. The 
difference is that this series only executes exact match 
queries (EMQ’s) on the ’’Publication:” field. This requires 
the exact name of the publication with only one space 
between each word (because that was the convention adhered 



to when the data 


entries were 


put 


in the database). 


The 


figure illustrates 


an example 


using 


the 


pub 1 i cat i on 


name 


INFORMATION & MANAGEMENT. In 


this 


case 


two titles 


were 



returned from the sample database. 

1 1 . R eport 

The menu item ’’Report” in Figure 11 is perhaps the 
most important of all of the selections in the application’s 
main menu. ’’Report” is one of the two ways in which to exit 
the program ’’references”. When the program is exited via 
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the '^Report” command all of the ”Saved'^ entries are 
assembled into a bibliography report format and placed in a 
file called ”bib I iography. report” , in the user^s directory. 
The name is coded into the program and is therefore 
invariant. A subsequent running of the program will result 
in the new report overwriting the old report, if the old 
report is not first renamed. The file name 
”bib I iography. report” is not sacrosanct and may be changed 
to any legal file name with no adverse effects to the 
content or format of the file. After the report is 
assembled and written to the file ”b ib I i ography . repor t ” a 
final screen appears to remind the user what the name of the 
file is and where to find it. At this point press <Return> 
to exit the program. 

12 . Quit 

Quit is the method for exiting the program without 
generating a report or the file ”bib I iography . repor t” . When 
”Quit” is executed all previously "Saved” files are first 
restored to "Unsaved” condition and the program then 
terminates without further ado. 

13. Cur sorHe I p 

Figure 23 is actually the entire file 
"keyhelp.txt”. It cannot all be viewed at once as 
illustrated in this figure, but may be scrolled through 
utilizing the commands provided by INGRES/ABF at the bottom 
of the screen. The type of help provided by "MenuHelp” is 
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slightly different from that of ^CursorHelp” but the 
functioning is identical. "MenuHelp" is not yet implemented 
for all screens . 

1 4 . Database Maintenance 

The bibliographical search and report system 
described above does not include an integral facility for 
updating the database. This was done by design for the 
purpose of maintaining database integrity. The database 
administrator (DBA) will be responsible for ensuring that 
appropriate entries are added to or deleted from the 
database. This can easily be accomplished through INGRES 
Query-By “Forms (QBF) by first invoking QBF and subsequently 
entering the QBF name ”form3'^ when prompted for a Table or 
QBF name. QBF provides all the functions necessary to add, 
delete, or update items in the database. An INGRES VIFRED 
forms description of the elements that comprise ”form3" can 
be found at the end Appendix B. 

C. THE PROGRAMMING ENVIRONMENT 

A frame is the basic screen oriented user interface in 
INGRES. The applications programmer, working from within 
the ABF environment, builds the two basic components of a 
frame, the form and the OSL specification for the frame. 
These two components are then combined, also from within 
ABF, to form frames. Figures 24 and 25 illustrate the 
Application Definition frame. The items in the menu at the 
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bottom of the frame indicate the range of operations 
available from within ABF. If the user selects "Rtingres”, 
the screen of Figure 1 appears, providing access to all of 
the INGRES subsystems. ’’Options" permits the user to select 
the text editor to be used to edit the ’’.osl” files. The 
’’.osl" files provide the menu selections for the frame to 
which it belongs, and contains the OSL and QUEL statements 
required to perform the actions indicated by the menu item 
names. "Define" and "Create” are used to initiate new 
applications or frames or to edit or redefine already 
existing frames. "Destroy” is used to destroy either a 
frame at a time or an entire application. ”Go" is used to 
run an application that is still in the development stage, 
particularly one that hasn’t yet been compiled .to a ”.exe" 
file. "Image” is the command to compile an application to 
an executable (.exe) file. Figure 26, the "User-Specified 
Frame Definition" frame, provides the remainder of the 
facilities required to develop an application. Of 
particular importance in this frame are "Compile", "Edit" 
and "Vifred". "Vifred" permits access to the forms editor 
to edit the form for the current frame without having to 
leave ABF. Edit allows for direct entry into the chosen 
editor with the appropriate ".osl” file as the object to be 
edited. "Compile” permits compiling of ”.osl” files for the 
purpose of checking for syntax and other related errors. 
Although beyond the scope of this thesis, a comment 
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regarding VIFRED is in order. Much of what can be done with 
an application is the result of the wide variety of 
attributes that may be edited into a form through the use of 
VIFRED's attribute editor, a frame from which is illustrated 
in Figure 27. Finally, although INGRES provides many ways 
to initiate a relation table in the database, there is 
probably none easier than by the selection of the "Table’’ 
option in the rtingres menu. The table information frames 
for the two tables which form the underlying relations for 
the sample database of this application, "descript2" and 
’’bibindex", are shown in Figures 28 and 29, respectively. 
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III. SUMMATION AND RECOMMENDATIONS 



Overall the INGRES Application-By-Forms (ABF) subsystem 
was found to be straightforward, easily understood, and 
easily used once the initial learning curve was passed. The 
initial task of gaining familiarity with the system is not 
an insignificant one. The first bit of wisdom gained by the 
experience of this development project is that it is 
necessary to learn nearly the entire INGRES system in order 
to make effective use of all of the facilities INGRES 
offers. In fact, it is necessary to learn the entire system 
in order to make effective use of just a portion of the 
system, and to know which is the appropriate portion to 
utilize for a given task. While it is true that an 
application may be built with the INGRES/ABF reference 
manual in hand, by modifying existing code in the examples 
in the manuals, such an approach results in applications of 
severely limited scope. 

A. LANGUAGES 

In addition to an overall systems knowledge, the 
prospective application programmer must allocate some time 
to gain familiarity with the languages used by the system. 
These are the Report Specification Language (RSL), the 
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Operations Specification Language (OSL), and Query Language 
(QUEL) . 

RSL is used primarily in conjunction with the INGRES 
Report-Writer and Report-By-Forms (RBF) subsystems. RSL is 
very similar in syntax and semantics to OSL, discussed 
below. RSL will not be discussed further since its systems 
lie outside the scope of this thesis. 

OSL is the language used in ABF to specify the menu 
items at the bottom of the screen, which is called a frame 
in INGRES. The majority of the later chapters of the 
App 1 ications-By-Forms User’s Guide CRef. 4] contain a 
combination tutorial and reference manual for OSL. OSL 
statements are collected into files with a ” . os 1 ” suffix to 
enable the INGRES system to identify its source code files. 
OSL commands can be, and usually are, combined with QUEL 
statements in order to broaden the scope and power of menu 
functions. The structure of OSL code segments is 
reminiscent of code segments, beginning and ending with 
the curly brace. However, OSL is semantically at the 
opposite end of the scale from resembling macros in the 
effect of its commands. OSL statements take the form of 
words and phrases such as ’’return”, ’’resume field”, 
’’callframe”, ’’callproc”, ’’exit” and so forth. OSL’s primary 
function is to direct the flow of control throughout an 
INGRES application program. As implied previously, OSL is 
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generally supplemented by QUEL statements in order to have a 
menu selection specified in OSL perform a data retrieval, 
update, or some similar database function for which QUEL is 
des i gned . 

INGRES QUEL is similar in syntax and semantics to the 
many other existing versions such as that offered by DBASE 
I I and III. The reader is referred to any general ly 
available text on the subject. QUEL, OSL, and RSL are all 
small but powerful languages designed for a specific, narrow 
purpose. Since they are smal 1 and the syntax is 
straightforward, it is easy to gain an appreciable measure 
of familiarity with them in a relatively short period of 
time. 

In summary, with respect to languages, the prospective 
INGRES applications programmer must either possess, or gain 
a working knowledge of QUEL and OSL in order to write the 
”.osl” modules required to bring function to menus. Once 
this aspect is mastered it is a simple matter to* change the 
menu items in any given frame/screen by simply changing a 
few OSL statements and recompiling the ”.osl” file. 

B. HELP SCREENS 

ABF, actually OSL, provides a uniquely easy to use 
facility for including help screens. The OSL command syntax 
is ’’helpfile ’ ’subject’ ^ filename ' where "subject" is a 
character string which will be inserted into the INGRES 
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system error message *^Sorry -- cannot open. help file on 
^ subject^ This message is displayed in the event that the 
system cannot locate the actual text file, f i ! ename^\ 
containing the information for the help screen. '' f i J ename'^ 
should contain the entire path designation required for the 
system to find the file. The ability to easily provide the 
end user with on-line help/assistance facilities encourages 
the application programmer to do so. This of course tends 
to foster more ’^user helpful”, if not ”user friendly” 
so f t war e . 

C. CURSOR CONTROL 

A very positive aspect of developing programs with ABF 
is the fact that the same cursor control features available 
to the applications programmer in the programming 
environment, are inherited by the application written in 
this environment, and are subsequently available to the end 
users of the application. All that remains is to make the 
end user aware of the capability and perhaps provide some 
on-line help, as was done in the application ^references” 
with the menu item ”Cur sorHe 1 p” , which is available on every 
screen. 

D. EFF I C I ENCY CONS 1 DERAT I ONS 

The response time of a database query is at least in 
part related to the storage structure of the data. Although 
not strictly a feature of ABF specifically, INGRES provides 
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some latitude in the selection of an appropriate storage 
structure for a given application. The default structure is 
the heap, but several others are available. RT 1 has 
provided some guidance on this issue with respect to the 
options available in the INGRES system [Ref. 5, chap 17]. 



E. OPERATIONS IN OSL 

The frames used in an application program may have 
primarily one of two origins; Query -By -For ms (QBF) frames 
and User-Specified frames. User-Specified frames provide 
the applications programmer with a considerable amount of 
latitude in both how a frame appears and how the frame 
operates. The operations in a User -Speci f i ed frame fall 
into three categories: menu items, field activations and 
initializations. Examples of all three of these methods of 
operation can be found throughout the program "references”. 
RT 1 [Ref. ^>Pg 9-11 provides the following explanations of 
these three categories .of operations: 

Menu items are the most common type of operation 
in a forms application. They provide the operations 
that appear in the menu at the bottom of the screen. By 
selecting a menu item, the user can execute the 
indicated operation. Such an operation could include a 
variety of specific actions, and could be a combination 
of database and forms manipulations. 

Field activations are less common, but nonetheless 
very useful. Field activations occur when an end-user 
enters a value in a field and then tries to move to the 
next field. If the application designer has defined a 
field activation on that field, then the operation 
specified is carried out. 
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An initialization occurs when a field is first 
displayed. Although initializations can cause any action 
to occur, they are normally used to set up the frame. 

An example of a field activation occurs in ’’references” 
in the frames under ’’Authors” and ”Pub I i ca t i ons ” which 
contain fields for month and year entries. An example of an 
initialization occurs in the ”View” frame. The code for 
this field activation is found in the OSL file 
” V i ewf r ame . os I ” . Menu items, as RT I remarks, are common and 
found throughout the application. 

F. FIELD ATTRIBUTES 

The ability to edit a field’s attributes was mentioned 
previously but deserves a section in the summary as well. 
This facility is actually a part of another INGRES 
subsystem, the Visual Forms Editor (VIFRED). VIFRED is the 
medium through which the forms, which make up the majority 
of that which is visible in a frame, are created and 
revised. It is highly recommended that the applications 
programmer become intimately familiar with the VIFRED 
subsystem. Mastering VIFRED will open an entirely new 
dimension in screen and field control through the proper 
utilization of field attribute editing. An examination of 
the menu of attributes that may be controlled. Figure 27, 
should serve to illustrate the point. There is at least one 
item in this list which is of limited utility, however. The 
ability to provide a default value for a field is severely 
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limited in its usefulness when it is for display purposes 
only. In the ’^Keyword” frame of the program ’’references", a 
default value of the wild card character, , was provided 
for the ’’Word/Phrase:’’ field, which is also a mandatory 
field. When the frame appears on the screen, the asterisk 
appears in the ’’Word /Phrase : ’’ field, but pressing <Return> 
only results in a system message to the effect that this is 
a mandatory field and an entry is required. This indicates 
that INGRES does not recognize the default value in a field 
as a legitimate query object. This fact is not well 
documented, if at all. 

G. MISCELLANEOUS 
i • Word Wrap 

The user will note, probably with some degree of 
subliminal irritation, that text in text fields does not 
word wrap. This shortcoming is not uniform throughout the 
INGRES system. Although the ability to have text. word wrap 
does not occur in the QBE or ABF associated subsystems, it 
is available in the RBF associated subsystems. Among other 
things, what this means to a user of an application such as 
’’references’^ is that any text the user views in frames on 
the screen will not word wrap, but the output report 
’’bib 1 iography. report’’ will have its text neatly word 
wrapped. INGRES is in a constant state of revision and 



35 



perhaps a future version will uniformly offer the option to 
have text fields word wrap, 

2 . Regularity Violation 

It is probably a bit strong to accuse RT 1 of a 
violation of the regularity principle [Ref, 6,pg 527], but 
they have come close in their "Vifred” menu selection in the 
ABF "User -Spec i f i ed Frame Definition” frame, Figure 26. In 
normal operation of the VIFRED subsystem, it is possible to 
"copy” an existing form, for whatever purpose, perhaps 
modification into a slightly different version of the same 
form. The method (undocumented) for copying a form is 
simply to enter VIFRED and arrive by whatever fashion at the 
"Forms Catalog" frame. Figure 30. Move the cursor to the 
form to be copied and select the "Edit" menu item. When the 
form appears on the screen, edit it as desired and then 
select "Save". The "Save" screen, Figure 31, will then 
appear with the old form’s name in the "form name:" field. 
In this instance, the name may be changed at this point and 
"Save" selected from the menu. The old form from which the 
new form was made is still in the forms catalog as is the 
new form. The sequence of events just described to copy a 
form cannot be accomplished if VIFRED was entered via the 
ABF "User-Specified Frame Definition" frame’s "Vifred" menu 
item. When the user /programmer arrives at the "Save" frame 
and attempts to change the name of the form, an error 
message appears indicating that this is not a permissible 
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action and that the form name is for display only. 



The 



reader is left to form his or her own opinion. 

3 • Retrieve Lockou t 

The problem described here is not fully understood, 
but is described for the purpose of forewarning a potential 
applications programmer about a possible ^’glitch” in the 
system. The User-Relation table field description for the 
relation ”descript2” is shown in Figure 28. During the 
course of developing the program "references”, several 

attempts were made to execute an imbedded QUEL retrieve of 
various items of the relation descript2 using other items 
from the relation, i.e., "retrieve descr i pt2. t i t 1 e where 
descr i pt2. author = ’ADIBA^," for example. All queries were 
handled satisfactorily except for one which always failed to 
compile in a ".osl" file. The query which always gave a 
syntax error was any query containing descr i pt2 . as the 

object of the query, i.e., "retrieve descr i pt2 . where 

descr i pt2 . author = ’ADIBA’." As can be seen from Figure 28, 
there is nothing different about this column in the relation 
descript2, except that it is the first one. The INGRES 
Reference Manual [Ref. 7] indicated that the word "key" was 
not a reserved word. There exists the possibility that 
INGRES considers the first column in any relation to be a 
"key" or "index" item as discussed in [Ref. 7,pg 2-24] and 
additionally that retrievals are not permitted on designated 
or default indexes. That is only speculation, however, with 
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no other evidence or documentation to substantiate the 



hy po t hes i s . 

4 . Defau lt d i t_^pj[^ 

ABF either contains or calls a default editor when 
the ’’Edit” function is called on a frame. ABF does provide 
for the programmer the opportunity to change the default 
editor for the duration of the current session through the 
’’Option” menu item. The problem arises that the default 
editor cannot be permanently changed by the user and the 
editor that RT 1 has chosen is not well known at this 
installation. It is neither ”vi” nor ”ex”, but does appear 
to be a line editor similar to ”ex”. Since ABF is a 

’’programming environment”, it would not seem unreasonable 
for the applications programmer to be permitted to designate 
his/her own default text editor on a semi -permanent basis. 
This suggestion is offered in the spirit of providing the 
user of the programming environment with a more congenial 
atmosphere in which to work. 

H. CLOSING COMMENTS 

Overall INGRES ABF was found to provide an extremely 
flexible application programming environment. The system is 
not difficult to learn from the standpoint of complexity or 
understanding, but the sheer bulk of the systems manuals is 
at first intimidating. It is noted that version 4.0 has 
arrived at this installation and that the manuals have been 
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reduced by half. 



It should be noted one last time that it 



is considered necessary for an applications programmer to 
learn the majority of the subsystems, unlike a casual user 
who only needs to learn QBF in order to make forms oriented 
queries. Once the initial learning curve has been 
surmounted, the system provides a very complete and 
comfortable application programming environment. 



39 



APPENDIX A. FIGURE S 



INGRES/HENU Database: bibiio 

To run a highlighted coiiand, place the cursor over it and 
select the "Go" eenu itei. 



Connands 


Description 


QUERY 


RUN siaple or saved QUERY to retrieve, lodify or append data 


REPORT 


RUN default or saved REPORT 


QBE 


Use QUERY-BY-FORHS to develop and test query definitions 


RBF 


Use REPORT-BY-FORHS to design or lodify reports 


ABF 


Use APPLICATIONS-BY-FORMS to design and test applications 


TABLES 


CREATE, HANIPUUTE or LOOKUP tables in the database 


VI FRED 


EDIT foras by using the VISUAL-FORHS-EDITOR 


QUEL 


ENTER interactive QUEL stateients 


SREPORT 


SAVE REPORT-URITER coaiands in the reports catalog 



Go History CoinandHode DBsuitch Shell Help Quit 



Figure 1 I NGRES/MENU ' s executive level menu 
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INGRES/HENU 



Database: biblio 



QUERY-BY-FORMS Intonation 



Enter a table naae, a qbfnaie, or a joindef naie: 



Change default options if desired: 

Type ("table", "qbfnaie", "joindef" or "any"): any 

If a table is specified, indicate if a table field is to be used 
("y", "n"): n 

Select the "Go" lenu itea to start QUERY-BY-FORHS. 

Go Help End 

Figure 2 Initial QBF screen from within INGRES/MENU 
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QBF - Start-Up Fraie 

Query-By-Foris (QBF) is an interactive interface for adding, deleting, 
changing and viewing data in your database. 

You lay get a catalog of QBFNaoes, JoinDefs, or Tables in your database 
to serve as a basis for editing and viewing. In suiiary, they are* 

QBFNaie - a naie that conbines a joindef or table naie with a 
fori naae. QBFNaies are created in VIFRED. 

JoinDef * a stored specification of joins between tables, and 
rules governing how to update data in QBF. 

Table - a table or view in your database. 

Froa each of the catalogs, you can browse naies, and choose one 
to serve as a basis for editing or viewing. 

Additional utility coinands on this lenu are* 

Help - displays help on QBF and your teriinal key functions. 
Quit - leaves QBF. 



QBFNaaes JoinDefs Tables Help Quit : 

Figure 3 INGRES QBF Start-up frame 
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INGRES/HENU 



Database: bibllo 



Go 

F i gure 



VISUAL-FORMS-EDITOR Infonation 



Enter a fora nane, table naae or joindef nane** 



Change default options if desired: 

Type ("fora", "table", "joindef"): fora 



Select the "Go" aenu iten to start VISUAL-FORMS-EDITOR. 

Help End 

4 Initial VIFRED screen from within INGRES/MENU 
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VIFRED - Forns Catalog 



Naae 


Owner 


addrfora 


destael 


projfora 


destael 


staffora 


destael 


taskfora 


destael 



Position cursor over the naae of the 
fora you wish to select, then use 
the aenu to perfora the appropriate 
operation on that fora. 



Create Destroy Edit Renane Utilities Find Top Bottoa > 

Figure 5 INGRES VIFRED Forms Catalog frame 
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INGRES/MENU 



Database: biblio 



REP0RT-BY-F0RI1S Inforaation 



Enter a table nane or a report naae: 



Change default options if desired: 

Type ("report", "table", "any"): any 
Suppress RBF status lessages ("y", "n")? n 

For report on table above, enter report style 
("block", "coluin", "wrap" or "default"): default 



Select the "Go" nenu itei to start REPORT-BY-FORMS. 



Go Help End 



Figure 6 RBF initial screen from INGRES MENU 
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RBF - Reports Catalog 



Position cursor over the naae of a report, then use the appropriate 
aenu iteni to perforn an operation on that report. 



Naae 


Owner 


RBF? 


Last changed 


subjlist 

j 


destael 


Yes 


4-nov-86 22'*50 



Create Destroy Edit Renaae Utilities Find Top Bottoa > 

Figure 7 RBF Reports Catalog frame 
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INGRES/HENU 



Database: biblio 



APPLICATIONS-BY-FORMS Inforaation 



Enter an application naie: 



Select the 'Go' lenu itei to start APPLICATIONS-BY-FORHS. 



Go Help End 



Figure 8 Initial ABF screen from within INGRES/MENU 
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APPLICATION DEFINITION 



APPLICATION CREATION INFORMATION: 

Application Nane : references Date Created : l8-nov-86: 17:52 

Application Creator ■ destael Date Modified : 19-nov-86: 17:02 



Source Code Directory : /uork/destael/reference 



Frane 




Procedure 


fraoeSa 






franeSay 






franeSai 






fraieSaiy 







Define Go Create Destroy Inage Rtingres Options Help > 

Figure 9 INGRES ABF Application Definition frame 



48 



• ye leone to REFERENCES >•> 



Would you like to see: 

<T> A list of Topics ( subject list ) 

<K> A list of titles containig a Key word or phrase 

( i.e. such as "DATABASE* or "FOURTH GENERATION LANGUAGE" ) 

<A> A list of titles based on sone coibination of Author and 
■onth and/or year 

<P> A list of titles based on sone conbination of Publication and 
Bonth and/or year 



CursorHelp MenuHelp Topics Keyword Author Publication > : 

Figure 10 Topframe (left half of menu) 
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• •• We leone to REFERENCES 

Would you like to see: 

<T> A list of Topics ( subject list ) 

<K> A list of titles contaioig a Key word or phrase 

( i.e. such as "DATABASE" or "FOURTH GENERATION LANGUAGE" ) 

(A> A list of titles based on sone coibination of Author and 
Bonth and/or year 

<P> A list of titles based on sone coibination of Publication and 
ionth and/or year 



< Publication Report Quit : 



Figure 11 Topframe (right half of menu) 



50 



Subject List 



Catcode 


Category Naaie 


H5 


DATABASE MAINTENANCE - OTHERS 


11 


DISTRIBUTED DATABASES 


12 


DISTRIBUTED DATABASE HANAGENENT SYSTEMS 


121 


SDD-1 


122 


HETEROGENOUS DISTRIBUTED DBMS'S 


13 


DESIGN, MODELING AND EVALUATION OF DISTRIBUTED DBMS'S 


131 


FILE AND PROCESS ALLOCATION 


132 




SYSTEM DESIGN OF DISTRIBUTED DBMS'S 



CursorHelp HenuHelp Titles End : 

Figure 12 Topics (subject list) frame 
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Category Code: H5 

Category: DATABASE MAINTENANCE - OTHERS 

Titles 

FLASH : A LANGUAGE- INDEPENDENT, PORTABLE FILE ACCESS SY 
STEM 

A HODa FOR AUTOMATIC FILE AND PROGRAM DESIGN IN BUSINE 
SS APPLICATION SYSTEM 

GENERALLY APPLICABLE DATA-FILE SOFTWARE 
GIS AND FILE MANAGEMENT 



CursorHelp MenuHelp View End : 



Figure 13 Titles frame 
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Press (CTRL) F to view bottoi of page. 

Month: MAY Article Description Year: 198i 

Title: FLASH : A LANGUAGE-INDEPENDENT, PORTABLE FILE ACCESS SY 
STEM 



Authors: ALLCHIN, J.E., KELLER, A.H., «IEDERHOL,D.G. 



•Publication: PROCEEDINGS OF ACM-SIGMOD 1980 INTERNATIONAL CONFERENCE 
ON MANAGEMENT OF DATA 



Abstract: 

A brief description (synopsis) of the article, not to exceed 1500 charac 
ters is to be inserted here... 



CursorHelp MenuHelp Save UnSave End : 



Figure 14 Viewframe 
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»>> Listing of Titles Containing a Key Uord or Phrase »»• 
Vord/Phrase: * 




CursorHelp HenuHelp View End * 



Figure 15 Keyword (initial) frame 
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Listing of Titles Containing a Key Uord or Phrase 
llord/Phrase: GIS 



Honth 



Year 



Title 



-J L. 



Cur sortie Ip NenuHelp View End 



Figure 16 Keyword (intermediate) frame 
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»»» Listing of Titles Containing a Key Word or Phrase 
Word/Phraset »GIS« 




CursorHelp MenuHelp View End 



Figure 17 Keyword (final) frame 
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Authors ••• 

Would you like to construct a list of titles based on: 

<0> Author* s naiBe Only 

<Y> Author*s naee and Year of publication of his/her article 

<H> Author* s naie and Month of publication of his/her article 

<A> Author* s naae and ionth and year (All) of publication of 
his/her article 

»•» Note ••• 



When entering the author* s naae the syntai is: "LASTNAME,F.M.**. 
Initials are not required but are desirable. 

There should be NO SPACES. 



CursorHelp MenuHelp Only Year Month All End : 

Figure 18 Authors frame 



57 



••• Month, Year, and Title of Article Based On Author's Naie Only 
Author: lADlBA* 



Month 


Year 


Title 


SEP 


1978 


ISSUES IN DISTRIBUTED DATA BASE MANAGEMENT SYSTEM: A TE 
CHI CAL OVERVIEW 


OCT 


1980 


AN OVERVIEW OF THE POLYPHEME DISTRIBUTED DATABASE MANAG 
EMENT SYSTEM 


SEP 


1978 


A DISTRIBUTED DATA BASE SYSTEM USING LOGICAL RELATIONAL 






MACHINES 



CursorHelp HenuHelp View End 



Figure 19 Author Only frame 
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Author: >DIB 



Titles Based On Author, Month, and Year 



Month: SEP 
Tear: 1978 



Title 



ISSUES IN DISTRIBUTED DATA BASE MANAGEMENT SYSTEM: A TE 
CHI CAL OVERVIEU 

A DISTRIBUTED DATA BASE SYSTEM USING LOGICAL RELATIONAL 
MACHINES 



CursorHelp HenuHelp View End 



Figure 20 



Author and Month and Year frame 



Publications 

Would you like to construct a list of titles based on: 

<P> Publication's nane only 

<Y> Publication's naae and Year of publication 

<H> Publication's naae and Month of publication 

<A> Publication's nane and nonth and year of publication (<A>I1) 

III 

NOTE: Put only single spaces between words in publication naies. 



CursorHelp HenuHelp PubNase Year Month All End : 

Figure 21 Publications frame 
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Honth, Year, and Title of Article Based On Publication Naae Only ■■■ 
Publication: INFORMATION & HANAGEHENT 




CursorHelp HenuHelp View End : 



Figure 22 Pub Name Only frame 
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HELP -- Coanand-Key Mapping for QUERY-BY-FORMS INFORMATION 



CoBiand 


Control /Function Key 


Explanation 


Henu 


ControlESC 


Go to or scroll through the lenu line 


Scroll up 


*F 


Go to next page of table or fori 


Scrol Idovn 




Go to previous page of table or fori 


Nextfield 


Tab 


Go to the next field 


Previousfield 


.p 


Go to the previous field 


Scroll left 


"0 


Scroll fori to the left 


Scrollright 


‘U 


Scroll fori to the right 


Startfield 


[ 


Go to start of current field 


Endfield 


] 


Go to end of current field 


Left char 


*H 


Move left one space 


Rightchar 


“L 


Move right one space 


Downline 




Move down one line 


Upline 




Move up one line 


Nextword 




Move forward one word 


Previousword 


'R 


Hove backward one word 


Mode 


"E 


Switch edit lode - insert/overstrike 


Redraw 




Redraw the screen 


Deletechar 


'D 


Delete character under cursor 


Rubout 


Delete 


Delete character to left of cursor 


Editor 


'V 


Start systei editor on field 


Nevrov 




Move to first coluin on next row 


Clear 


'X 


Clear field or lenu input 


Clearrest 


Return 


Clear field froi cursor to end 


Duplicate 


'A 


Duplicate last value entered 


Printscreen 




Write current screen to file 


Go 






Help 






End 







NeitPage('F) PrevPagef^G) Find Top Bottoi Help End 



Figure 23 CursorHelp frame text file 
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APPLICATION DEFINITION 



APPLICATION CREATION INFORMATION: 

Application Naae : references Date Created : l8-nov-86: 17:52 

Application Creator : destael Date Modified : 15*dec-86:02:£3 



Source Code Directory : /work/destael /reference 



Fraoe 




Procedure 


kwfr 






pub frame 






pofr 






pifr 







Define Go Create Destroy Image Rtingres Options Help > *• 



Figure 24 Application Definition frame (left half) 
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APPLICATION DEFINITION 



APPLICATION CREATION INFORHATION: 

Application Naee : references Date Created : 18-nov-B6: 17:52 

Application Creator : destael Date Modified : 15-dec-86:02:03 



Source Code Directory : /uork/destae I /reference 



Fraee 




Procedure 


kufr 






pubfraie 






pofr 






pifr 







< Help Quit : 



Figure 25 Application Definition frame (right half) 
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User-Specified 

Fraie Naae : endfr 
Usage : USER 
Fon : endfori 



Fraie Definition 

Creation Date * 14-dec-86: 15:51 

Modification Date : 14-dec-86: 16:39 

Return Type : character 
("integer", "float", "character", 
or "none") 



Define Compile Destroy Edit Print Vifred Help End : 

Figure 26 Frame Definition frame 
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VIFRED - Attributes for Field 



Attribute 


Set 


Box Field 


n 


Keep Previous Value 


n 


Mandatory Field 


y 


Reverse Video 


y 


Blinking 


n 


Underline 


n 


Brightness Change 


n 


Query Only 


y 


Force Lower Case 


n 


Force Upper Case 


y 


No Auto Tab 


n 


No Echo 


n 


Display Only 


n 


END OF AHRIBUTES 





Default Value for Field: 



Internal Name for Field (12 characters only): 
authors 



Validation Check to Perfori on Field: 



Validation Error Message: 



Color: 0 



Next Previous Help End 



Figure 27 VIFRED Field Attributes Editing frame 
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INGRES TABLE UTILITY 



Database: biblio 



Inforoation on table descript2 



Coluin Na«e 


Data Foriat 


key 


c7 


authors 


Cll0 


title 


cl65 


publication 


cllB 


VO 1 use 


il 


nunber 


il 


nonth 


c3 


year 


i2 


pages 


c9 


catcode 


c3 


synop 


teitdSBB) 


reptout 


cl 



Owner: destael 

NuBber of Colunns: 12 
Nunber of Rows: 63 

Table Type: 

Storage Structure: heap 
Row Uidth: 1914 

Journaling: 



USER RELATION 



Disabled 



NevTable Find Top Bottoi Help End 



Figure 28 Database Relation Table "descript2” 
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INGRES TABLE UTILITY 



Database: biblio 



infonation on table bibindex 



Owner: 

Nunber of Colunns: 
Nuiber of Rous: 
Table Type: 

Storage Structure: 
Row Width: 
Journaling: 

NeuTable Find Top Bottoi Help End 



Colunn Naie 


Data Foriat 


Key No. 


catcode 


c3 




catnaAe 


c6» 


i — . — -- 



destael 

2 

22 

USER RELATION 

heap 

63 

Disabled 



Figure 29 Database Relation Table 



bibindex^’ 



VIFREO - Forms Catalog 



Name 


Owner 


authfori 


destael 


ay 


destael 


endforn 


destael 


forii3 


destael 


kv 


destael 


pn 


destael 


pay 


destael 


po 


destael 


pubforn 


destael 


py 


destael 


subj 


destael 


titles 


destael 


top fori 


destael 


viewfon 


destael 



Position cursor over the name of the 
form you wish to select, then use 
the menu to perform the appropriate 
operation on that fora. 



Create Destroy Edit Rename Utilities Find Top Bottom > 



Figure 30 VIFRED Forms Catalog frame 
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VIFRED - Save Fora 



This fraie is used to save the fora definition in the 
database. You should enter the naae for the fora here. 



Fora Naae : vievfora 



A QBFNaae with the saae naae as the fora will be created 
for a new fora created froa a table or joindef. 



Save Forget Help 



Figure 31 



VIFRED Form Save frame 
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APPENDIX B 



0 SJ-. COD E SEGMENTS AND I NCH E Sjyj F RED FOR MS 

DESCR I PT 1 ONS 

/»••••• ••••/ 

/• »/ 

/• Progran Nane: "references” Date: 16 Deceaber 1986 ■/ 

/• •/ 

/> Author: Jaoes F. De Stael, LCDR, USN ■/ 

/* »/ 

/■ Prepared in conjunction with Masters Thesis at the Naval Postgraduate School •/ 
/» Monterey, California 93943 »/ 

/» »/ 

/• DBMS: INGRES Version 4.B •/ 

/» Operating Systea: UNIX BSD 4.2 •/ 

/• Hardware: VAX 11/785 •/ 

/• •/ 

/•••••••••• 

/> All INGRES foras descriptions were prepared •/ 

/« using INGRES VIFRED/Utilities/Print »/ 

/> INGRES fora description for topfora ■/ 



••• Uelcoae to REFERENCES ••• 

Would you like to see: 

<T> A list of Topics ( subject list ) 

<K> A list of titles containig a Key word or phrase 

( i.e. such as "DATABASE" or "FOURTH GENERATION LANGUAGE" ) 

<A> A list of titles based on soae coabination of Author and 
Bonth and/or year 

<P> A list of titles based on soae coabination of Publication and 
aonth and/or year 
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Fora nane: topfora 
Forn owner: at 

Nuiber of colunns on screen: 81 
Nuiber of lines on screen: 16 
Nuiber of fields: 0 
Nuiber of tria strings: 9 
Date last lodified: 15-dec-86 



FIELD DESCRIPTIONS 
/» Hone »/ 



/» File: topfraae.osl «/ 

"CursorHelp" = { 

helpfile "Cursor Control" 

"/work/destael/reference/keyhel p. txt"; 

1 

■MenuHelp* = { 

helpfile "Opening Fraae" 

"/work/des tael /reference/ tophelp.txt"; 

1 

•Topics" = ( 

callfrane subjfr; 

1 

"Keyword" = { 

call fraae kwfr; 

) 

•Author" = { 

call fraae authfraae; 

1 

■Publication" = ( 

call fraae pubfraae; 

1 

"Report" = { 

call fraae endfr; 

) 

■Quit" = { 

lessage "restoring database to original condition..." 
sleep 2; 

range of d is descript2; 
replace d lreptout="N") ; 
aessage "Bye-bye y’all"; 
sleep 2; 
eiit; 

) 



99 



72 



/• INGRES fori description for authfori •/ 



»•» Authors 

Would you like to construct a list of titles based on: 

<0> Author *s naie Only 

<Y> Author’s naie and Year of publication of his/her article 

<M> Author’s naae and Month of publication of his/her article 

<A> Author’s naie and lonth and year (All) of publication of 
his/her article 



»»• Note ••• 

When entering the author's naae the syntax is: »LASTNAME,F.M.". 
Initials are not required but are desirable. 

There should be NO SPACES. 



Fora naie: authfori 
Fora owner: at 

Nuaber of coluans on screen: 80 
Nuiber of lines on screen: 19 
Nuaber of fields: 0 
Muiber of tria strings: 11 
Date last lodified: 13-dec’86 



FIELD DESCRIPTIONS 
/• None •/ 
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/• File! authfrai.osl »/ 



•CursorHelp" = ( 

helpfile "Cursor Control* 

"/work/destael/reference/keyhelp. tit*. 

} 

•MenuHelp’ = { 

helpfile "Authors-etc Frate* 

■/work/destael/reference/authhelp. tit*i 

1 

•Only" = I 

callfraee aofr. 

I 

•Year" = I 

callfrane ayfr; 

1 

•Month" == { 

callfrane aifr. 

) 

"All* = { 

callfrane aiyfri 

1 

•End* = i 
return; 

) 
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/• INGRES fori description for ao (author only fori) >/ 



Month, Year, and Title of Article Based On Author’s Naie Only 
Author: 



+ + f + 

IMonthlYearlTitle I 



Fom naie: ao 
Fora owner: at 

Muiber of coluans on screen: 00 
Nuaber of lines on screen: 22 
Nuiber of fields: 2 
Nuaber of trii strings: i 
Date last aodified: 12-dec-86 



FIELD DESCRIPTIONS 



Field naae: authors 
Field title: Author: 

Display foraat: -cll0.55 

Special display attributes: Mandatory field, Reverse video. Force upper case 
Type of field: regular 
Default value: 

Validation check: 

Validation error aessage: 
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Field naiie*. keytitle 
Type of field: table field 



Field name: nonth 
Field title: Honth 
Display foriat: c3 

Special display attributes: Display only, Force upper case 
Type of field: coluin in table fieldcat 
Default value: 

Validation check: 

Validation error message: 



Field name: year 
Field title: Year 
Display format: i4 

Special display attributes: Display only 
Type of field: column in table field 
Default value: 

Validation check: 

Validation error message: 



Field name: title 
Field title: Title 
Display format: cl65.55 

Special display attributes: Display only, Force upper case 
Type of field: column in table field 
Default value: 

Validation check: 

Validation error message: 
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/• File: aofr.osl (author only frame osl module) •/ 



•CursorHelp" = ( 

helpfile "Cursor ControT 

"/work/destael/reference/keyhelp. txt"; 

) 

•MenuHelp* = ( 

helpfile "Author-Only Frame* 

"/work/destael/reference/aohelp. txt"; 

) 

field authors = { 

authors := + authors ♦ 

ao. keytitle := retrieve (aonth = descript2.aonth, 
year = descript2.year, title = descript2. title) 
where (descript2. authors = authors); 
resuae field keytitle; 

) 

"View" = ( 

callfraae viewfraae (title := keytitle. title); 
resuae field keytitle; 

) 

•End" = C 
return; 
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/» INGRES fore description for an (author-aonth fora) »/ 



»»» Year and Title Based On Author and Honth »»» 



Author: 



Month: 



♦ + ♦ 

lYearlTitle I 

|==sst====sr=rr==r==zs=s=r==========r====z===r=xs======r===== j 



+ + f 



Fora naae: ai 
Fora ovner: at 

Nuaber of coluans on screen: 80 
Nuaber of lines on screen: 22 
Nuaber of fields: 3 
Nuaber of tria strings: l 
Date last aodified: 12-dec-86 
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FIELD DESCRIPTIONS 



Field naae: authors 
Field title: Author: 

Display fomat: *cil0.S5 

Special display attributes: Mandatory field, Reverse video, Force upper case 
Type of field: regular 
Default value: 

Validation check: 

Validation error aessage: 



Field naae: nonth 
Field title: Month: 

Display fortat: c3 

Special display attributes: Mandatory field. Reverse video. Force upper case 
Type of field: regular 
Default value: 

Validation check: aonth in [■JAN","FEB\"MAR","APR","HAY","JUN»,"JUL","AUG«,«S 
EP","0CT",«N0V",«DEC") 

Validation error aessage: Month aust be standard 3- letter abbreviation. 



Field naae: keytitle 
Type of field: table field 



Field naae: year 
Field title: Year 
Display foraat: i4 

Special display attributes: Display only 
Type of field: coluan in table field 
Default value: 

Validation check: 

Validation error message: 



Field name: title 
Field title: Title 
Display foraat: cl65.55 

Special display attributes: Display only, Force upper case 
Type of field: coluan in table field 
Default value: 

Validation check: 

Validation error message: 
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/• File: aifr.osl (author-nonth frane osl lodule) >/ 



*CursorHelp" = ( 

helpfile "Cursor Control" 

"/work/des tael /ref erence/keyhel p. tit" ; 

} 

"MenuHelp" = { 

helpfile "Author-Month Fraie" 

"/work/destae I /ref erence/aihel p. txt" ; 

) 

field "authors" = { 

authors := ♦ authors ^ 

resume field nonth; 

) 

field "aonth" = ( 

aa.keytitle := retrieve (year = descript2.year, 
title = descript2. title) 
where (descript2. authors = authors 
and descript2.fionth = aonth); 
resuae field keytitle; 

) 

"View" = { 

callfraae viewfraie (title keytitle. title); 
resuae field keytitle; 

) 

"End" = ( 
return; 

) 

"CursorHelp" = ( 

helpfile "Cursor Control" 

"/work/destael /ref erence/keyhel p. tit" ; 

) 

"MenuHelp" = { 

helpfile "Author-Month-Year Fraae" 

"/work/destael /ref erence/aayhel p. txt" ; 

) 

field "authors" = { 

authors "»" + authors ♦ 
resume field aonth; 

) 

field "aonth" = ( 

resume field year; 

) 

field "year" = ( 

aay. keytitle := retrieve (title = descript2. title) 
where (descript2. authors = authors 
and descript2. month = aonth 
and descript2.year = year); 
resuae field keytitle; 
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"View" = ( 

callfraie vievfrane (title *• keytitle. title); 
resuie field keytitle; 
i 

"End" = I 
return; 

) 



m 



81 



/• INGRES fon description for ay (author-year fori) 



Month and Title Based On Author and Year ••• 



Author: 



Year: 



♦ f + 

IHonthlTitle I 

\ZZZZZ^ZZZZZZZZTZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZ^ZZZZ^=ZZZZZ\ 



+ ♦ - ♦ 



Forn naie: ay 
Fora owner: at 

Nuiber of coluans on screen: 80 
Nuaber of lines on screen: 38 
Nuiber of fields'* 3 
Nuaber of trii strings: 1 
Date last aodified: 13-dec-86 
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FIELD DESCRIPTIONS 



Field naiie** authors 
Field title: Author: 

Display foraat: -cll0.55 

Special display attributes: Mandatory field, Reverse video, Force upper case 
Type of field: regular 
Default value: 

Validation check: 

Validation error lessage: 



Field naie: year 
Field title: Year: 

Display foriat: -i4 

Special display attributes: Mandatory field, Reverse video 
Type of field: regular 
Default value: 

Validation check: year >= 1800 and year <= 2200 

Validation error aessage: Year must be 4-digit foraat between 1800 & 2200 



Field naae: keytitle 
Type of field: table field 



Field naae: nonth 
Field title: Month 
Display foraat: c3 

Special display attributes: Display only, Force upper case 
Type of field: coluan in table field 
Default value: 

Validation check: 

Validation error aessage: 



Field name: title 
Field title: Title 
Display foraat: cl65.55 

Special display attributes: Display only. Force upper case 
Type of field: coluan in table field 
Default value: 

Validation check: 

Validation error aessage** 
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/» File: ayfr.osi (author-year frame osl module) »/ 



•CursorHelp" = I 

helpfile "Cursor Control" 

•/vork/destael/reference/keyhelp. txt"; 

1 

•MenuHelp" = { 

helpfile "Author-Year Frame" 

"/work/destael/reference/ayhelp.txt"; 

) 

field "authors" = ( 

authors := authors ^ 
resume field year) 

} 

field "year" = ( 

ay. keytitle := retrieve (month = descript2. month, 
title = descript2. title) 
where (descript2. authors = authors 
and descript2.year = year); 
resume field keytitlei 

) 

"View" = I 

callfraie viewframe (title := keytitle. title); 
resume field keytitle; 

•) 

"End" = ( 
return; 

) 
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/» INGRES foro description for ao (author-ionth-year fon) */ 



»»» Titles Based On Author, Month, and Year i»» 



Author: Month: 

Year: 




Fori naie: any 
Fora owner: at 

Nuiber of colunns on screen: 81 
Nuiber of lines on screen: 23 
Nuiber of fields: 4 
Nuiber of trii strings: l 
Date last lodified: 13"deC"86 



FIELD DESCRIPTIONS 



Field nane: authors 
Field title: Author: 

Display fornat: -cll0.55 

Special display attributes: Mandatory field, Reverse video. Force upper case 
Type of field: regular 
Default value: 

Validation check: 

Validation error nessage: 
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Field nase: nonth 
Field title*. Month*. 

Display foraat: c3 

Special display attributes: Mandatory field. Reverse video, Force upper case 
Type of field: regular 
Default value: 

Validation check: Bonth in [•JAN*,"FEB","MAR","APR","MAV","JUN","JUL’,"AUG%"S 
EP","0CT","N0V",«DEC"1 

Validation error nessage: Month Bust be standard 3-letter abbreviation. 



Field naae: year 
Field title*. Year: 

Display foriat: -i4 

Special display attributes: Mandatory field, Reverse video 
Type of field: regular 
Default value: 

Validation check: year >= 1800 and year <= 2200 

Validation error aessage: Year aust be 4-digit foriat between 1800 and 2200 



Field naie: keytitle 
Type of field: table field 



Field naae: title 
Field title: Title 
Display foriat: cl65.55 

Special display attributes: Display only, Force upper case 
Type of field: coluan in table field 
Default value: 

Validation check: 

Validation error aessage: 
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/» File** aiyfr.osl (author-ionth-year frane osi lodule) »/ 



•CursorHelp" = ( 

helpfile "Cursor Control" 

"/work/destael/reference/keyhelp.txt"; 

) 

■MenuHelp" = { 

helpfile "Author -Honth-Year Fraae" 

"/work/destael/reference/afiyhelp. txt"; 

1 

field "authors" = { 

authors := + authors ^ 

resume field month; 

) 

field "month" = ( 

resume field year; 

1 

field "year" = I 

amy.keytitle := retrieve (title = descript2. title) 
where (descript2. authors = authors 
and descript2. month = month 
and descript2.year = year); 
resume field keytitle; 

) 

■View" = { 

callfraae viewfrane (title keytitle. title); 
resume field keytitle; 

1 

•End" = { 
return; 
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/* INGRES fori description for kw (key word forn) >/ 



Listing of Titles Containing a Key Word or Phrase »»» 
Uord/Phrase: 



f ♦ f ♦ 

IMonthlYearlTitle 1 

\::ZZZ^ZZZZiZZZZZZZZZZZZZZZZZZZZZZZZZ,ZZZZZZZZZZZZZZZZZZZZZZ^ZZZZZ2i\ 



f + f + 



Forn naoe: kw 
Forn owner: at 

Nuiber of coluins on screen: 80 
Nuaber of lines on screen: 22 
Muiber of fields: 2 
Nuaber of trii strings: 1 
Date last lodified: 15*dec*86 



FIELD DESCRIPTIONS 



Field naae: title 
Field title: Uord/Phrase: 

Display foraat: *cl65.55 

Special display attributes: Mandatory field, Reverse video, Force upper case 
Type of field: regular 
Default value: • 

Validation check: 

Validation error aessage: 
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Field nane: keytitle 
Type of field: table field 



Field name: month 
Field title: Honth 
Display format: c3 

Special display attributes: Display only, Force upper case 
Type of field: column in table field 
Default value: 

Validation check: 

Validation error message: 



Field name: year 
Field title: Year 
Display format: i4 

Special display attributes: Display only 
Type of field: column in table field 
Default value: 

Validation check: 

Validation error message: 



Field name: title 
Field title: Title 
Display format: cl65.55 

Special display attributes: Display only, Force upper case 
Type of field: column in table field 
Default value: 

Validation check: 

Validation error message: 
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/• File: kyfr.osl (key word frane osl aodule) •/ 

•CursorHelp" = ( 

helpfile "Cursor Control" 

"/work/destael/reference/keyhelp. txt"; 

) 

•MenuHelp" = ( 

helpfile "Key Word Fraie" 

"/work/destael/reference/kwhelp.txt"; 

) 

field "keyword" = ( 

keyword := ^ keyword f 

kw. keytitle retrieve (nonth - descript2.ionth, 

year = descript2.year, title = descript2. title) 
where (descript2. title = keyword); 
resune field keytitle; 

) 

"View" = { 

callfrane viewfraae (title := keytitle. title); 
resuae field keytitle; 

) 

"End" = ( 
return; 
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h INGRES fort description for subj (topics (subject list) fon) »/ 



Subject List 



+ + 

Catcode! Category Naae 



Forn naie: subj 
Fora ownerJ at 

Nuiber of coluans on screen: 80 
Nuaber of lines on screen: 26 
Nuiber of fields: 1 
Number of tria strings: 1 
Date last lodified: 14-dec-86 
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FIELD DESCRIPTIONS 



Field naae: subjiist 
Type of field: table field 



Field naae: catcode 
Field title: Catcode 
Display foriat: c3 

Special display attributes: Display only, Force upper case 
Type of field: coluin in table field 
Default value: 

Validation check: 

Validation error aessage: 



Field name: catnaie 
Field title: Category Na&e 
Display foriat: c60 

Special display attributes: Display only, Force upper case 
Type of field: coluin in table field 
Default value: 

Validation check: 

Validation error lessage: 



/» File: subjfr.osl (topics (subject list) fraie osl lodule) •/ 



initialize = { 

subj. subjiist := retrieve (catcode = bibindex. catcode, 
catnaie = bibindex. catnaae) ; 
resuae field subjiist; 

) 

■CursorHelp" = ( 

helpfile "Cursor Control" 

■/work/destael/reference/keyhelp. txt"; 

) 

■MenuHelp" = ( 

helpfile "Subject List Fraie" 

"/work/destael/reference/subjhelp. txt"; 

) 

■Titles" = { 

callfraie titlefr (catcode := subj list. catcode; 
catnaae := subj list. catnaie) ; 

) 

■End" = ( 



return; 

) 
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/• INGRES forn description for titles (titles-by-category form) »/ 



Category CodeJ 



Category: 



+ 

1 Titles 



+ 









Fori naie: titles 
Forn owner: at 

Nunber of colunns on screen: 80 
Nuiber of lines on screen** 33 
Nuaber of fields: 3 
Nuiber of tria strings: 0 
Date last lodified: 14-dec-86 
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FIELD DESCRIPTIONS 



Field naae: titlelist 
Type of field: table field 



Field naie: title 

Field title: Titles 

Display foraat: cl65.55 

Special display attributes: Display only, Force upper case 
Type of field: coluan in table field 
Default value: 

Validation check: 

Validation error lessage: 



Field naae: catcode 
Field title: Category Code: 

Display foriat: c3 

Special display attributes: Display only, Force upper case 
Type of field: regular 
Default value: 

Validation check: 

Validation error oessage: 



Field naae: catnaie 
Field title: Category: 

Display foraat: c60 

Special display attributes: Display only. Force upper case 
Type of field: regular 
Default value: 

Validation check: 

Validation error aessage: 
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/* File: titlfr.osl (titles-by-category fraie osl nodule) */ 



initialize = { 

titles. titlelist := retrieve (title = descript2. title) 
where (descript2.catcode = catcode); 
resuae field titlelist; 

) 

•CursorHelp** = { 

helpfile "Cursor Control" 

"/work/destael/reference/keyhelp. txt"; 

} 

"MenuHelp" = { 

helpfile "Titles Frane" 

"/work/destael /reference/tit I help. txt"; 

) 

•View" = { 

callfrane viewfraae (title := titlelist. title); 
resuae field titlelist; 

I 

"End" = { 
return; 

) 
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/» INGRES fon description for pubfora (selection-by-publication naae fora) »/ 



««» Publications 

Would you like to construct a list of titles based on: 

<P> Publication's naae only 

<Y> Publication's naae and Year of publication 

<I1> Publication's naae and Month of publication 

<A> Publication's naae and aonth and year of publication (<A>11) 

III 

NOTE: Put only single spaces between words in publication nanes. 



Forn naae: pubfora 
Fora owner: at 

Nuiber of coluans on screen: 80 
Nuaber of lines on screen: 20 
Nuiber of fields: 0 
Nuaber of tria strings: 8 
Date last lodified: 15-dec-86 



FiaO DESCRIPTIONS 
/» None »/ 
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/> File: pubfr.osi (publications selection fraie osl oodule) •/ 



*CursorHelp" = I 

helpfile "Cursor Control" 

"/work/destael /ref erenceZkeyhelp.txt"; 

) 

•MenuHelp" = { 

helpfile "Publication-etc Fraie" 

"/work/destael/reference/pubhelp. txt"i 

) 

■PubNaie" = I 

calif rase pofr; 

) 

"Year" = I 

callfraae pyfr; 

) 

■Month" = { 

callfrane pifri 

) 

•All* ^ { 

callfraoe payfri 

) 

•End* = { 
return; 

] 
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/• INGRES fori description for po (publication naie only fori) •/ 



••• Month, Year, and Title of Article Based On Publication Naie Only 
Publication: 



f ♦ - - + 

IMonthlYeariTitle 1 

\zz:zzz^zzzz\zzz~zzzzzzzzzz:zzzzz:zzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzz\ 



♦ 4 4 4 



Fora naie: po 
Fori owner: at 

Nuiber of coluins on screen: 80 
Nuiber of lines on screen: 22 
Nuiber of fields: 2 
Nuiber of trii strings: 1 
Date last eodified: 15*dec'86 



FIELD DESCRIPTIONS 



Field naie: publication 
Field title: Publication: 

Display foriat: -cll0.55 

Special display attributes: Mandatory field, Reverse video, Force upper case 
Type of field: regular 
Default value: 

Validation check: 

Validation error message: 
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Field naae: keytitle 
Type of field: table field 



Field naae: sonth 
Field title: Month 
Display foraat: c3 

Special display attributes: Display only. Force upper case 
Type of field: coluan in table field 
Default value: 

Validation check: 

Validation error aessage: 



Field naae: year 
Field title: Year 
Display foraat: i4 

Special display attributes: Display only 
Type of field: coluan in table field 
Default value: 

Validation check: 

Validation error message: 



Field naae: title 
Field title: Title 
Display foraat: cl65.55 

Special display attributes: Display only, Force upper case 
Type of field: coluan in table field 
Default value: 

Validation check: 

Validation error aessage: 
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/• File: pofr.osi (publication naie only fraie osl lodule) */ 

•CursorHelp" = ( 

helpfile "Cursor Control" 

"/work/destael/reference/keyhelp. txt"; 

) 

•MenuHelp" = ( 

helpfile "Publication-Only Fraiie" 

"/work/destael/reference/pohelp.txt"; 

) 

field "publication" = { 

po.keytitle := retrieve (aonth = descript2.aonth, 
year = descript2.year, title = descript2. title) 
where (descript2. publication = publication); 
resuBie field keytitle; 

) 

•View" = I 

callfraie viewfraae (title := keytitle. title); 
resuse field keytitle; 

} 

"End" = { 
return; 



100 



/• INGRES fon description for pa (publication naae and aonth fora) >/ 



Year and Title Based On Publication Naae and Honth 

Publication** 

Month: 



f + f 

lYearlTitle I 

I zzzz^zzzzzzzzzzzzzzzzzzzzzzzzzzzzzzz::zzzz=zzzz-zzzzzzzzzzzzz\ 



+ + - + 



Fora naae: pa 
Fora owner*, at 

Nuaber of coluans on screen: 81 
Nuiber of lines on screen: 23 
Nuaber of fields: 3 
Nuiber of tria strings: 1 
Date last aodified: l5-dec-86 



FIELD DESCRIPTIONS 



Field naae*. publication 
Field title: Publication: 

Display foraat: -cllB.55 

Special display attributes: Mandatory field, Reverse video, Force upper case 
Type of field: regular 
Default value: 

Validation check: 

Validation error aessage: 
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Field naae: nonth 
Field title: Month: 

Display foroat: c3 

Special display attributes: Mandatory field. Reverse video, Force upper case 
Type of field: regular 
Default value: 

Validation check: nonth in l"JAN","FEB","MAR","APR\"MAY%"JUN»,"JUL*,"AUG","S 
EP","OCT»,"NOV",*DEC*3 

Validation error aessage: Month lust be standard 3- letter abbreviation. 



Field naie: keytitle 
Type of field: table field 



Field naae: year 
Field title: Year 
Display format: i4 

Special display attributes: Display only 
Type of field: coluan in table field 
Default value: 

Validation check: 

Validation error message: 



Field name: title 
Field title: Title 
Display format: cl65.55 

Special display attributes: Display only, Force upper case 
Type of field: coluan in table field 
Default value: 

Validation check: 

Validation error message: 
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h File: pifr.osl (publication naie and Bonth fraie osl lodule) >/ 



■CursorHelp" = { 

helpfile "Cursor Control" 

■/work/destael/reference/keyhelp. txt"J 

} 

•MenuHelp" = ( 

helpfile "Publication-Month Fraae" 

"/work/destael/reference/pihelp. txt"; 

} 

field "publication" = ( 
resune field aonth; 

) 

field "lonth" = ( 

pa. keytitle := retrieve (year = descript2.year, 
title = descript2. title) 

where (descript2. publication = publication 
and descript2.Bonth = aonth); 

resuae field keytitle; 

) 

•View" = { 

callfraae viewfraae (title := keytitle. title); 
resuae field keytitle; 

) 

■End" = { 
return; 

) 

■CursorHelp" = { 

helpfile "Cursor Control" 

■/work/destael/reference/keyhelp. txt"; 

) 

■MenuHelp" = ( 

helpfile "Publication-Month- Year Fraae" 
"/work/destael /ref erence/payhel p. txt" ; 

) 

field "publication" = { 
resuae field Bonth; 

1 

field "aonth" = { 

resuae field year; 

) 

field "year" = { 

pay. keytitle := retrieve (title = descript2. title) 
where (descript2. publication = publication 
and descript2. aonth = lonth 
and descript2.year = year); 
resuae field keytitle! 
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•View" = { 

callfrane viewfraae (title := keytitle. title); 
resuie field keytitle; 

) 

•End" = { 
return; 

) 



8 
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/• INGRES forn description for py (publication naiie and year fori) •/ 



»»» Honth and Title Based On Publication and Year ••• 



Publication: 

Year: 



+ + + 

IMonthlTitle 1 

;====r+==r===========rr====r======:=rrrrsr===========r=r=r====| 



+ + I 



Fori naie: py 
Form owner: at 

Nufflber of coluans on screen: 88 
Nuiber of lines on screen: 37 
Nunber of fields: 3 
Nuiber of tria strings: l 
Date last lodified: 15-dec-86 
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FIELD DESCRIPTIONS 



Field naie: publication 
Field title: Publication: 

Display foraat: -cll0.55 

Special display attributes: Mandatory field, Reverse video, Force upper case 
Type of field: regular 
Default value: 

Validation check: 

Validation error Message: 



Field naie: year 
Field title: Year: 

Display foriat: -i4 

Special display attributes: Mandatory field, Reverse video 
Type of field: regular 
Default value: 

Validation check: year >= 1800 and year <= 2200 

Validation error Message: Year must be 4-digit foraat between 1800 & 2200 



Field naae: keytitle 
Type of field: table field 



Field naoe: aonth 
Field title: Month 
Display foraat: c3 

Special display attributes: Display only, Force upper case 
Type of field: coluan in table field 
Default value: 

Validation check: 

Validation error Message: 



Field name: title 
Field title: Title 
Display foraat: cl65.55 

Special display attributes: Display only, Force upper case 
Type of field: coluan in table field 
Default value: 

Validation check: 

Validation error Message: 
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/> File: pyfr.osl (publication naie and year frame osi module) •/ 

■CursorHelp" = ( 

helpfile "Cursor Control* 

"/work/destael/reference/keyheip. txt"; 

1 

■MenuHelp* = ( 

helpfile "Publication-Year Frame" 

"/work/destael/reference/pyhelp. txt"; 

1 

field "publication" = ( 
resume field year; 

1 

field "year" = I 

py.keytitle := retrieve (iionth = descriptZ. month, 
title = descript2. title) 
where (descript2. publication = publication 
and descript2.year = year); 
resume field keytitle; 

) 

■View" = { 

callframe viewfraae (title := keytitle. title); 
resume field keytitle; 

) 

"End" = { 
return; 
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/• INGRES forn description for pay (publication naie and lonth and year fori) »/ 

I Honth: ••• Titles Based On Publication, Month, and Year >>• Year: 

I Publication: 




Forn nane: pay 
Fora owner: at 

Ruiber of coluans on screen: 80 
Nuaber of lines on screen: 22 
Nuiber of fields: 4 
Nuaber of trii strings: 1 
Date last lodified: 15-dec-86 



FIELD DESCRIPTIONS 



Field naie: publication 
Field title: Publication: 

Display foraat: -cll0.55 

Special display attributes: Mandatory field, Reverse video, Force upper case 
Type of field: regular 
Default value: 

Validation check: 

Validation error aessage: 
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Field nane! Donth 
Field title: Month: 

Display forioat: c3 

Special display attributes: Mandatory field, Reverse video, Force upper case 
Type of field: regular 
Default value: 

Validation check: nonth in ["JAN","FEB","MAR","APR%"MAY","JUN*,"JUL",*AUG","S 
EP\ "OCT", "NOV", "DEC"] 

Validation error message: Month must be standard 3-letter abbreviation. 



Field name: year 
Field title: Year: 

Display format: -i4 

Special display attributes: Mandatory field, Reverse video 
Type of field: regular 
Default value: 

Validation check: year >= 1800 and year <= 2200 

Validation error message: Year must be 4-digit format between 1800 and 2200 



Field name: keytitle 
Type of field: table field 



Field name: title 
Field title: Title 
Display format: cl65.55 

Special display attributes: Display only. Force upper case 
Type of field: column in table field 
Default value: 

Validation check: 

Validation error message: 
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h File: poyfr.osl (publication naae and nonth and year fraie osl Module) >/ 



•CursorHelp’’ = i 

helpfile "Cursor Control* 

■/work/destael/reference/keyhelp.tit"; 

) 

•MenuHelp" = ( 

helpfile "Publication-Month-Year Frame" 
■/work/destael/reference/payhelp. txt"; 

) 

field "publication" = I 
resuae field lonth; 

) 

field "aonth" = { 

resuae field year; 

) 

field "year" = I 

pay.keytitle := retrieve (title = descript2. title) 
where (descriptZ. publication = publication 
and descriptZ. month = aonth 
and descriptZ.year = year); 
resuae field keytitle; 

) 

"View" - { 

callfraae viewfraae (title := keytitle. title); 
resume field keytitle; 

) 

■End" = ( 
return; 

) 
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/* INGRES fora description for viewform (view the current title) »/ 



Press <CTRL> F to view bottoi of page. 
Month! Article Description 

Title: 



Authors: 



Publication: 



Abstract: 



Forn nane: viewfora 
Ford owner: at 

Nuaber of columns on screen: 81 
Kuiber of lines on screen: 39 
Number of fields: 6 
Nuiber of trim strings: 2 
Date last modified: 13-dec-86 



Year: 
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FIELD DESCRIPTIONS 



Field naie: south 
Field title: Month: 

Display foraat: c3 
Special display attributes: 
Type of field: regular 
Default value: 

Validation check: 

Validation error message: 



Display only, Force upper case 



Field nase: year 
Field title: Year: 

Display forsat: -i4 

Special display attributes: Display only 
Type of field: regular 
Default value: 

Validation check: 

Validation error message: 



Field name: title 
Field title: Title: 

Display format: -cl65.55 

Special display attributes: Display only, Force upper case 
Type of field: regular 
Default value: 

Validation check: 

Validation error message: 



Field name: authors 
Field title: Authors: 

Display format: *cll0.S5 

Special display attributes: Display only, Force upper case 
Type of field: regular 
Default value: 

Validation check: 

Validation error message: 
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Field naie: publication 
Field title: Publication: 

Display foraat: -cll0.55 

Special display attributes: Display only, Force upper case 
Type of field: regular 
Default value: 

Validation check: 

Validation error aessage: 

Field naae: synop 
Field title: Abstract: 

Display foraat: cl500.72 
Special display attributes: Display only 
Type of field: regular 
Default value: 

Validation check: 

Validation error aessage: 



/» File: viewfraae.osl (view the current title fraae osl aodule) •/ 
initialize = { 

viewfora := retrieve ( authors = descriptZ. authors, 
ionth = descriptZ.aonth, year = descript2.year, 
publication = descript2. publication, synop = descript2, synop ) 
where ( descript2. title = title ); 

) 

•CursorHelp" = ( 

helpfile "Cursor Control* 

"/work/destael/reference/keyhelp.txt"; 

) 

•henuHelp" = ( 

helpfile "View Fraae" 

•/work/destael/reference/viewhelp. txt"; 

} 

"Save" := { 

replace descript2 (reptout = "Y") where descript2. title = title! 
aessage "Entry aarked for inclusion in bibliography report file"! 
sleep 2; 

1 

•UnSave" = { 

replace descript2 (reptout = "N") where descript2. title = title; 
aessage "Entry UNaarked...wil 1 NOT appear in bibliography report file"! 
sleep 2; 

} 

"End* = { 
return! 

) 
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/» INGRES fori description for endforn (closing screen (after report generation) fori) »/ 



FINAL SCREEN 

REPORT GENERATION COMPLETE 



Your report is now in your directory 
in a file naned "bibliography. report" 



Press <RETURN> to continue*. 



Fora naoe: endfora 
Fora owner: at 

Nuaber of coluans on screen: 80 
Nuiber of lines on screen: 19 
Nuaber of fields: 1 
Nuiber of tria strings*. 5 
Date last lodified: 16-dec-06 



FIELD DESCRIPTIONS 



Field name: leave 
Field title: to continue: 

Display foriat: -cl 

Special display attributes: No echo 

Type of field: regular 

Default value: x 

Validation check: 

Validation error oessage: 



114 



/• File: endfr.osl (closing fraae (after report generation) osl nodule) »/ 



initialize = { 

■essage "Generating your report..."; 
sleep 3; 

lessage "Press return when prompted to do so..."; 
sleep 3; 

call "report" ("flags" = "-s", "file" = "bibliography. report", 
"report" = "bibliography", "parai" = "reptout^Y"); 
range of d is descript2; 
replace d (reptout="N") ; 
resume field leave; 

) 

field "leave" = { 
exit; 
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/» INGRES for® description for for»3 (relation "descript2* data entry fora) »/ 



Article Description 

Titled 



Authors^ 

Publication^ 



Voluae: 


Nuiber: 


Month: 


Year: 


Pages: 


ReptOut (Y/N): 


Catcode: 


Key: 



Abstract: 



Fora nane: fora3 
Forn owner: at 

Nuaber of coluans on screen: 80 
Nuaber of lines on screen: 40 
Nuaber of fields: 12 
Nuaber of tria strings: I 
Date last aodified: l2‘dec-86 
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FIELD DESCRIPTIONS 



Field naoe: key 
Field title: Key: 

Display foriat: c7 

Special display attributes: Force upper case 
Type of field: regular 
Default value: 

Validation check: 

Validation error nessage: 



Field naie: authors 
Field title: Authors: 

Display fornat: -cll0.55 

Special display attributes: Force upper case 

Type of field: regular 

Default value: 

Validation check: 

Validation error lessage: 



Field naae: title 
Field title: Title: 

Display fornat: -cl65.55 

Special display attributes: Force upper case 

Type of field: regular 

Default value: 

Validation check: 

Validation error lessage: 



Field nane: publication 
Field title: Publication: 

Display fornat: -cll0.55 

Special display attributes: Force upper case 

Type of field: regular 

Default value: 

Validation check: 

Validation error nessage: 
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Field naie: voluie 
Field title: Voluae: 

Display fornat: !6 
Special display attributes: None 
Type of field: regular 
Default value: 

Validation check: 

Validation error lessage: 



Field naie: nuiber 
Field title: Nuiber: 

Display foriat: f6 
Special display attributes: None 
Type of field: regular 
Default value: 

Validation check: 

Validation error lessage: 



Field name: sionth 
Field title: Month: 

Display foraat: c3 

Special display attributes: Force upper case 
Type of field: regular 
Default value: 

Validation check: 

Validation error nessage: 



Field naie: year 
Field title: Year: 

Display foriat: f8 
Special display attributes: None 
Type of field: regular 
Default value: 

Validation check: 

Validation error oessage: 



Field name: pages 
Field title: Pages: 

Display foriat: c9 
Special display attributes: None 
Type of field: regular 
Default value: 

Validation check: 

Validation error aessage: 
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Field name: synop 
Field title: Abstract: 

Display format: cl500.72 
Special display attributes: None 
Type of field: regular 
Default value: 

Validation check: 

Validation error message: 



Field name: catcode 
Field title: Catcode: 

Display format: c3 

Special display attributes: Force upper case 
Type of field: regular 
Default value: 

Validation check: 

Validation error message: 



Field name: reptout 
Field title: ReptOut (Y/N): 

Display format: -cl 

Special display attributes: Reverse video, Force upper case 
Type of field: regular 
Default value: N 

Validation check: reptout in [®Y","y","N*,"n"l 

Validation error message: This field must be either "Y* or "N" 
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